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The Jini™ Architecture 
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AR.1 Introduction 

can live within the system. 
AR.1.1 Goals of the System 

by human and computational clients. Resources can oe i y 
Hardware devices, software programs, or a ^ination of 

the system is to make the ^^r^SSZSS TJ^ denser- 
dynamic nature of the workgroup by enabbng the aomty to auu 

vices flexibly. 

A Jini system consists of the following parts: 

♦ A set of components that provides an infrastructure for federating services 
in a distributed system 
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♦ AprogrammingmodeimatsupportsandencouragestheproductionofreU- 

able distributed services 

♦ Services that can be made part of a federated Jini system and that offer func- 
tionality to any other member of the federation 

Althoueh these pieces are separable and distinct, they are 

include the following: 

♦ Enabbng users to share services and resources over a network 

♦ Providing users easy access to resources anywhere on the network while 
allowing the network location of the user to change 

♦ Simplifying the task of building, maintaining, and altering a network of 
devices, software, and users 

^ * • et» m ^nds the Java™ application environment from a single vir- 
TTie Jim system ext ends the Java app^ plication environment pro- 

tual machine to a network of machines, ine Java «w . m ^ e 

S ^currentiy possible in networked groups where configuring a network is a 
centralized function done by hand. 
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AR.1.2 Environmental Assumptions 

■m Jini systtm federals computers ^<«^*SS 

lecture gains much of Its simplicity from assuming th* the_ ^ ^^Jkally 
j££ if the implementauon language for ^^.J^^^architec- 
Lfnloao ana run code is centra! to a number of ^ "J^f ~ ^kcm 



1 *As used in this document, the terms 
Java platform. 



-Java virtual machine" or "JVM" mean a virtual machine for the 



BNSDOC1D: <XP 2279289A_I_> 



INTRODUCTION 



BNSDOCID: <XP 2278289A_L> 



THEJINI™ ARCHITECTURE SPECIFICATION, version 12 



AR.2 System Overview 



AR.2.1 Key Concepts 

The purpose of the Jini — « ? ^ ~SJJS 

ware components into a , «£k ^/>^ C ^nistration, and support for 

tion provides the simplicity of ^^'^ c °'^ m wMe retaining the flexibil- 

for larger organizations. 

AR.2.1.1 Services 

™ most important™^ 

vice is an entity that can be used by a person^ a ^^^channel to another user, a 
vice may be a computation storag ^ a ™ples of services are 

^Members of a Jini system federate to *-^^^2^ 
should not be thought of as sets of client ^^^^^collected 
programs and files. Instead, a Jim system consists ofserv* ^™ ^ 
^ the performance of a ^arucu arttsfc ofits own . 

services, and a client of one serv,ce may ^lf bea^ withdrawn 
The dynamic nature of a Jim system enables re quire- 
from a federation at any time according to demand, need, or the changing require 
m ents of the workgroup using ^ s^tem lookup, communi- 

.dorru^^^ 
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as printers, displays, or disks; software such as applications or utilities; informa- 
tion such as databases and files; and users of the system. 

in a Jini system communicate with each other by wag a ^> 
Jp^hSh is a set of interfaces written in the Java programming language. The 
riXmtocl's open ended. The base Jini system defines a small number 
of such protocols that define critical service interactions. 



AR-2.1^ Lookup Service 



Services are found and resolved by a lookup service. The lookup service is the 
Sn™K*apping ^^J^^T^^ ^ 
^ ^^Z^ tZ7X^y a service to «. 
ofTbTeTL SSent the service. In addition, descriptive entfies associated 
alTow more fine-grained selection of services based on properties 

" d S^ e riSp e service may include other lookup services; tins provides 
°c£ ook T Further, a lookup service may contain objects that encapsu- 
rroSSrSry services, providing a way for bridges to be unfit 
^ve^n a iStap service and other forms of lookup service. Of course, refer- 
etcTto I Z\ZZ>^ -ay be placed in these other naming Rectory 
serScS, providing a means for clients of those services to gam access to a Jim 

^Tservice is added to a lookup service by a pair of protocols called tecovery 
and £2X *e service locates an appropriate lookup service (by usmg the dis- 
covery protocol), and then it joins it (by using thejoin protocol). 

AR2.13 Java Remote Method Invocation (RMD 

Communication between services can be accomplished using Java Remote 

^Fund^en^^Ta Java programming language-enabled extension to 

Scity of the Jini system is enabled by this, fcibty to move code 
around the network in a form that is encapsulated as an object 
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AR^.1.4 Security 



tern. Services themselves may request access to °™ rse ™^ is 



the object. 
AR2.1.5 Leasing 



Access to many of the services in the ,ini *». ^^S^ neg^o 
iease is a grant of guaranteed access over ah me P^^ 1 ^ „. 
between the user of the service ^^^TjLT^^ granted for some 
vice protocol: A service is requested for ^J^'^^g a lease is no t 
period, presumably '^^^^^ t Zr^7"oZ^ needed, the 

one may take a lease on the resource during the period of the lease, non 
exclusive leases allow multiple users to share a resource. 

AR-2.1.6 Transactions 

cai, Be wrapped in a mw*Klu»i. The Juu ™= aansaoiMS are imple- 

s^^j^rxizsrs^^-.Jup 

to the service using those interfaces. 
AR-2.1.7 Events 

•me .il aKhUecrara supports MAM "-^J? 2S 
with a variety of reliability and scalability guarantees. 
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AR.2.2 Component Overview 

The components of the Jini system can be ^entedi^ U^ ^f^^ 
Patent that the distinction between them can seem blurred. Moreover, it is P^sum 

famfliar Java application environment are shown in Figure AK.Z. l ■ 
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Java 

+ 
Jini 
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Distributed Security 
Lookup 
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AR2.2.1 Infrastructure 

T* Jini technology 1— «— «- «* — ' Jlnl KC,,M,0^, ^ ^ 
infrastructure includes the following: 

services to ihe otter members of the federation, 
. Ito lookup service, wh*h serves as 

s»SSr s ,ocal 

proxies to the service that placed the code into the lookup service. 

^ discovery and Join V^A^ 
becomes part of a Jini system; ^^SSSLSSd! security model and 
Jini technology-enabled services comm^icate, ^ «M» * t0 

its implementation define ^^f^f^^^rs; and the lookup 

Programming Model 

■n» Insecure bo* eoab.es the F-*---* J»«*J- 
Entries in the lookup service ere ^*^«*^^S. or leave a 
accm-dy the set of cuneatly latere* In 

tooknp sendee, events are ^^•Ti^ b ^ K 7avallable or old sertces 

Clonal endues that exist ^£~ZZ2££2 «nJlnLion promts 

res ro^T^-sr^t- » — — 
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model. Among the interfaces that make up the Jini programming model are the 
following: 

♦ Tlie leasing interface, which defines a way of allocating and freeing 
resources using a renewable, duration-based model 

♦ The event and notification interfaces, which are an extension of the event 
moused by JavaBeans™ components to the distributed environment, 
e^e ewntWd communication between Jini technology^nabled ser- 

vices 

* The transaction interfaces, which enable entities to cooperate in such a way 

* 2 eXTor fte chang'es made to the group occur atomicaUy or none of 
them occur 

The lease interface extends the Java programming language model by adding 
^JSStSZ holding a reference to a resource, enabling references to be 

^e^^tSSTSi* the standard ~ 

cha^gS it made. In the second step, a coordinator issues a commit request to 
^meSni transaction protocol differs from most transaction interfaces in ft* : tt 

^^KSSSSfS*. d> Jini programme mode, are used by me Mr* 
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KKSKSSSSBgSSSSS tt*** 

objects that support ^Jf^^ requirea to use the Jini programming 
The implementation of a service is noi "*1«" interaction with the Jini 

«U. but such services need to use .that model ^^Xr^s with the Jini 
technology infrastructure. For example every semce i 

rSTil— ^^^S^„ a «. infraanKhKe 

The binding of the progtamming mMel to tte^vicra^ 
is what makes such a federanon a J.m sj^m no^a^le^o^ 

ESSSS^SSsES-- 

ARJ2.23 Services 

The Jin, technoiogy inftashuch-e and XW"-* STSX. 
X-,SrSSS^r=frt« - — and . 

language, perhaps made up of °^f^ t A J^ Some of these interfaces are 
the operations that can be requested ^^f^^^ded to be run by the 
intended to be used by ^^^^^r^^of the service deter- 
receiver so thaT the semce can ^^^ ^Se the set of methods 
Z e T^~Z:Z SET-* service may be implemented by 

♦ A printing service, which can print from apphca^nswritteninthe Java pro- 
^ammini language as weU as legacy applications 

♦ LavaSpac^ service, w*ch^ 

storage of related groups of objects written in the Java programmi g 

guage 
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♦ A transaction manager, which enables groups of objects to participate in the 
Jini transaction protocol defined by the programming model 

AR.2.3 Service Architecture 

Services form the interactive basis for a Jini system, both at the programming and 
useTSrS levels. Hie details of the service architecture are best understood 
once the Jini discovery and Jini lookup protocols are presented. 

A R.23.1 Discovery and Lookup Protocols 

The heart of the Jini system is a trio of protocols called discovery, join, and 
,^Ta ^ of these protocols-discovery and join-occur when a device s 
oluSSdtn^scover; occurs when a service is looking for a lookup service with 
Sic regi Z Join occurs when a service has located a lookup service and 
w£Ss to St Lookup occurs when a cheat or user needs to locate and invoke a 
se^Tce ISed^its interface type (written in the Java programming language) 
anTp^STother attributes. Figure AR.2.2 outlines the discovery process. 



A service provider seeks 
a lookup service 



Lookup 
Service 



Client 



((* 



Service 
Provider 



Service Object 



Service Attributes 



Figure AR.2.2: Discovery 



Jini discovery/join is the process of adding a service to a Jini system. A ser- 
vice 22r i me originator of the service-a device or software, for example^ 
R^ ui service provider locates a lookup service by multicasung a request on the 
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-men, a service ob ^ V^n^Ts fte Java programming language interface for 
£i£c?S Locations win invoke to exe- 

S^STS^ alon| with any other descriptive attnbutes. 
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A service provider registers a 
service object (proxy) and its 
service attributes with 
the lookup service 
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Services must be able to find a lookup service; however, a service ^dele- 
gated S finding a lookup service to a third party. The service xsnovv ^ady 
?o bVtooked up and used, as shown in the following diagram (Figure AR.2.4). 



A client requests a service by 
Java programming language 
type and, perhaps, other service 
attributes. A copy of the service 
object is moved to the client and 
used by the client to talk to the 
service 
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Service Attributes 





Service 
Provider 



Figure AR.2.4: Lookup 



A client locates an appropriate service by its type-that is, by its mterto 
into the client 
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TO M «e is to invoice «he servics, as shown in « folding diagmn 
(Figure AR.2.5). 



The client interacts directly with 
the service provider via the 
service object (proxy) 



Lookup 
Service 



Service Object 



Service Attributes 




Service 
Provider 



figure AR.2.5: Client Uses Service 



service and from there to the chent °f the semce ^ dients. This 

freedom in the communication P 8 ^^"^ ^ client and the ser- 
code movement also ensures ^^^^^SwL service object is 
vice for which it is a proxy are always syn it is deaUng with an 
supplied by the service itself. J^^ammiiW so 

^mentation of an ^ terfa ^ tt ^Vl^teSTs^eeded to provide the ser- 
code that implements the uiterf ace do wta^v^s £ code ^ ^ 

vice. Because this code came <*^J^££^ are known only to the 
advantage of implementation details of the service 

code. . - 0 _ of interfaces written in the Java 

The client interacts with a ^™™™lTl ^tof methods that can be 
programming language. These ""erfac^ne the ^ by ^ 

used to interact with the service, ^og^amrnauc found in a 

type system of the Java ^^^^S'a^^ar interface. Finding a 
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use that service, because that use is defined by the set of methods that are defined 

^ ^Xnmatic interfaces may be implemented either as RMI references to the 
remo^oSeTmat implements the service, as a local computation that pro-desall 
locally or as some combination. Such combinations called smart 
pr Ties Tu^pTement some of the functions of a service locally and the remainder 
through remote calls to a centralized implementation of the service^ 

Auser interface can also be stored in the lookup service as an atmbute _of a 
reeisterS service. A user interface stored in the lookup service by a Jim teclmol- 
o?ySl£™-ice is an implementation that allows the service to be directly 

ma T^l *™i!TjT> service is a specialized form of die service 
interface S cnZls a program, such as a browser, to step out of the way and let 
the human user interact directly with a service. 

In situations in which no lookup service can be found, a chent could I use a 
technique called peer lookup instead. In such situations, the chent can send _ou 
s^nTSenUfication packet that is used by a lookup service to request serv.« ^ pro- 
vX TregSer. Service providers will then attempt to register with the chent ^as 
S, * were a lookup service. The chent can select the services it needs from 
me regislation requests it receives in response and drop or refuse the rest 

AR-2.3-2 Service Implementation 

Obiects that implement a service may be designed to run in a single address space 
objects especially when there are , c^*^-— £ 
based requirements. Such objects make up an object group An ^ 
gSant2d to always reside in a single address space or virW^m^lune when 
obiects are running. Objects that are not in the same object group are iso- 
SSSJSToO-sr. typically by running them in a different virtual machine or 

""TIES may be implemented direcdy or indirectly ^^^Z 
Such devices can be contacted by the code associated with the interface for the 

^rSmi the service client's point of view, there is no distinction between set- 
vi J tot^fmTlSiented by objects on a different machine, services that are 
3S52TlT& local adLss space, and service. 

hardware. All of these services will appear to be available on die ^orK wm 
appear to be objects written in the Java programming language, and only as far as 
functioning is concerned, one kind of implementation could be replaced 
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by another kind of implementation without change or knowledge by the client 
(Note that security permissions must be properly granted.) 
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AR.3 An Example 

This example shows how a Jini technology-enabled printing service™^ 
7t !Z 1 camera to print a high-resolution color image. It will start with 
r^To£g C rSsSig Jini sysLn, continue with its being configured, and 
end with printing the image. 

AR3.1 Registering the Printer Service 

a ,~ that * either freshly connected to a Jini system or is powered up once it 
^service art rcgi.Br with it Ibis is the tiisc»veo> and jot phase. 
ARJ.1.1 Discovering the Lookup Service 

The basic operations of discovering the lookup service are implemented byaBni 
SSgy Etrucnne software class. An instance of « class ^ts as ameto- 

S5S2L devices - ™ ^T.SKSS. S? £ 2£ 

™r,S."rS otoSTSat are pntxiesV the discover looknp 
services. 

AR3.1.2 Joining the Lookup Service 

t Z 55 5LJESE SSL. v^, — 

possible paper sizes, and printing resolution. 



BNSDOC1D: <XP 2279289A_I_> 



AN EXAMPLE 



The printer then calls the regi ste r method of the lookup service object that it 
received during the discovery phase, passing it the printer service object and the 
array of attributes. The printing service is now registered with the lookup service. 



ARJ.1-3 Optional Configuration 

At this point the printing service can be used, but the local system administrator 
might want to add additional information about the printer in the form of addi- 
tional attributes, such as a local name for the service, information about its physi- 
cal location, and a list of who may access the service. The system administrator 
might also want to register with the device to receive notifications for any errors 
that arise, such as when the printer is out of paper. 

One way the system administrator could do this would be to use a special util- 
ity program to pass this additional information to the service. In fact this program 
might have received notification from the lookup service that a new service was 
being added and then alerted the system administrator. 



AR3.1.4 Staying Alive 

When the printer registers with the Jini lookup service it receives a lease. Periodi- 
cally, the printer will need to renew this lease with the lookup service. If the 
printer fails to renew the lease, then when the lease expires, the lookup service 
will remove the entry for it, and the printer service will no longer be available. 



AR.3.2 Printing 

Some services provide a user interface for interaction with them; others rely on an 
application to mediate such interaction. This example assumes that a person has a 
digital camera that has taken a picture they want to print on a high-resolution 
printer. The first thing that the camera needs to do after it is connected to the net- 
work is locate a Jini technology-enabled printing service. Once a printing service 
has been located and selected, the camera can invoke methods to print the image. 

AR3.2.1 Locate the Lookup Service 

Before the camera can use a Jini technology-enabled service, it must first locate 
the Jini lookup service, just as the print service needed to do to register itself. The 
camera registers itself with a local instance of the Jini technology infrastructure 
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class LookupDiscovery, which will notify the camera of all discovered lookup 
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services. 



AR3.2^ Search for Printing Services 

Finding an appropriate service requires passing a template that is used to match 
and filter the set of existing services. The template specifies both the type of the 
required service, which is the first filter on possible services, and a set of attributes 
which is used to reduce the number of matching services if there are several of the 
right type In this example, the camera supplies a template specifying the printer 
type and an array of attribute objects. The type of each object specifies the 
attribute type, and its fields specify values to be matched. For each attribute, fields 
that should be matched, such as color printing, are filled in; ones that don't matter 
are left null The Jini lookup service is passed this template and returns an array of 
all of the printing services that match it If there are several matching services, the 
camera may further filter them— in this case perhaps to ensure high print resolu- 
tion— and present the user with the list of possible printers for choice. The final 
result is a single service object for the printing service. 

At this point the printing service has been selected, and the camera and the 
printer service communicate directly with each other, the lookup service is no 
longer involved. 

AR3.2.3 Configuring the Printer 

Before printing the image, the user might wish to configure the printer. This might 
be done directly by the camera invoking the service object's configure method; 
this method may display a dialog box on the camera's display with which the user 
may specify printer settings. When the image is printed, the service object sends 
the configuration information to the printer service. 

AR3-2.4 Requesting That the Image Be Printed 

To print the image, the camera calls the print method of the service object, passing 
it the image as an argument The service object performs any necessary prepro- 
cessing and sends the image to the printer service to be printed. 
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AR3.2.5 Registering for Notification 

If the user wishes to be notified when the image has been printed, the camera 
needs to register itself with the printer service using the service object. The cam- 
era might also wish to register to be notified if the printer encounters any errors. 

AR3.2.6 Receiving Notification 

When the printer has finished printing the image or encounters an error, it signals 
an event to the camera. When the camera receives the event, it may notify the user 
that the image has been printed or that an error has occurred. 



